home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / fdetach.z / fdetach
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ffffddddeeeettttaaaacccchhhh((((3333CCCC))))                                                        ffffddddeeeettttaaaacccchhhh((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh - detach a name from a STREAMS-based file descriptor
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _iiii_nnnn_tttt _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_))))_;;;;
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh routine detaches a STREAMS-based file descriptor from a name
  16.      in the filesystem.  _p_a_t_h is the pathname of the object in the filesystem
  17.      name space, which was previously attached (see _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh(3C)).  The user
  18.      must be the owner of the file or a user with the appropriate privileges.
  19.      All subsequent operations on _p_a_t_h will operate on the filesystem node and
  20.      not on the STREAMS file.  The permissions and status of the node are
  21.      restored to the state the node was in before the STREAMS file was
  22.      attached to it.
  23.  
  24. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  25.      If successful, _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh returns 0; otherwise it returns -1 and sets _eeee_rrrr_rrrr_nnnn_oooo
  26.      to indicate an error.
  27.  
  28. EEEERRRRRRRROOOORRRRSSSS
  29.      Under the following conditions, the function _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh fails and sets _eeee_rrrr_rrrr_nnnn_oooo
  30.      to:
  31.  
  32.      _EEEE_PPPP_EEEE_RRRR_MMMM        The effective user ID is not the owner of _p_a_t_h or is not a
  33.                   user with appropriate permissions.
  34.  
  35.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR      A component of the path prefix is not a directory.
  36.  
  37.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT       _p_a_t_h does not exist.
  38.  
  39.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL       _p_a_t_h is not attached to a STREAMS file.
  40.  
  41.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG The size of _p_a_t_h exceeds _{{{{_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX_}}}}, or a pathname component
  42.                   is longer than _{{{{_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX_}}}} while _{{{{______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC_}}}} is in
  43.                   effect.
  44.  
  45.      _EEEE_LLLL_OOOO_OOOO_PPPP        Too many symbolic links were encountered in translating
  46.                   _p_a_t_h.
  47.  
  48. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  49.      fdetach(1M), fattach(3C), streamio(7)
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.